home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr37 / ho5m.zip / INSTALL.TXT < prev    next >
Text File  |  1995-03-02  |  16KB  |  401 lines
  1.  
  2.  
  3.                The Quick & Easy Install manual                 Page 1
  4.  
  5.  
  6.  
  7.  
  8.                         _______
  9.                    ____|__     |               (R)
  10.                 --|       |    |-------------------
  11.                   |   ____|__  |  Association of
  12.                   |  |       |_|  Shareware
  13.                   |__|   o   |    Professionals
  14.                 -----|   |   |---------------------
  15.                      |___|___|    Member
  16.  
  17.  
  18.  
  19.           February, 1995
  20.  
  21.  
  22.           Install is designed to allow you to install and run your
  23.           software including demonstration programs, and maintenance
  24.           software.  You may also use it as a general install program,
  25.           to setup software that you only use occasionally and the
  26.           like.  Install stores its help information and script
  27.           instructions in the INSTALL.DBF and INSTALL.DBT Xbase database
  28.           files.  You can edit the help by tapping F7 instead of F1
  29.           -Help while running install or you can start install with the
  30.           "EDIT" command line parameter.  Install always looks in the
  31.           last active, or undeleted, entry for its script instructions.
  32.           You can take advantage of this by putting alternate
  33.           installation sets in other dbase deleted entries and
  34.           undeleting them for particular disk distributions.  Don't
  35.           leave the last entry blank, or install will yell at you.  This
  36.           installer was originally setup for the TeleShare remote access
  37.           package, but this release matches the Hands On remote access
  38.           package.  Some of the Teleshare features are not used with
  39.           Hands On, but they are retained and may become useful for
  40.           particular installations.
  41.  
  42.           Command line parameters
  43.  
  44.           INSTALL [EDIT ADD MONO RECNO#]
  45.  
  46.           EDIT   - to edit the script database
  47.           ADD    - to add a new entry and edit the script database.
  48.           MONO   - to force monochrome screen output.
  49.  
  50.  
  51.           The install script language follows:
  52.  
  53.  
  54.           # is used for comments.  Anything to the right of a # is
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                The Quick & Easy Install manual                 Page 2
  61.  
  62.  
  63.           considered a comment.
  64.  
  65.           Every install script must start with the line.
  66.           "TELESHARE INSTALL SCRIPT"
  67.  
  68.           Otherwise the installer might try to work over one of its own
  69.           help files, and snivel at you.
  70.  
  71.  
  72.           BROWSE somefile to browse or review some text file for
  73.           information.  It has a built-in search capability.
  74.  
  75.           CHANGEDISK key_file To prompt to change to the next diskette,
  76.           and to check for the specified key file on the next disk.  You
  77.           can leave a space and add a message that will be displayed in
  78.           place of "Please change disks" after the key_file name.  Do
  79.           not use a zero length key_file name.
  80.  
  81.           CHANGEDISK peaches.exe Please change to the red disk.
  82.  
  83.           CLEAR to clear the screen.  This version actually calls the
  84.           DOS CLS to ensure that the screen color/colour matches similar
  85.           DOS related commands that you may be using in association with
  86.           it.
  87.  
  88.           COMMAND to directly run programs and to pass commands to
  89.           command.com.  See the RUN and SWAP commands below.
  90.  
  91.           COPY - to allow copying of materials from the source to target
  92.           disk as in:
  93.           COPY file_1 file_2 file_3 etc
  94.  
  95.           The destination is the DIRECTORY provided earlier.
  96.  
  97.  
  98.           DIRECTORY - to supply a directory name for editing.
  99.  
  100.           ECHO like the DOS echo.  Anything that is not recognised by
  101.           the script parser is simply echoed to the screen, but any
  102.           spaces on the left side will be trimmed off.
  103.  
  104.           IF and END or ENDIF If is used with ADD-IN or BASIC, as in
  105.           IF  BASIC
  106.              # installation commands for the BASIC option
  107.              ...
  108.           ENDIF
  109.           IF ADD-IN
  110.              # installation commands for the ADD-IN option
  111.              ...
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                The Quick & Easy Install manual                 Page 3
  118.  
  119.  
  120.           END
  121.           if add-in basic
  122.              # to combine the partial installation options
  123.              ...
  124.           endif
  125.  
  126.           IF direct_install
  127.              # direct_install is a logical switch
  128.              # that becomes TRUE if the 'last file'
  129.              # is found at the start of the install
  130.              run save HOMENU.BAT
  131.              QUIT
  132.           ENDIF
  133.  
  134.           The final "END" or "ENDIF" is an implied "QUIT", so if you use
  135.           one of the two optional partial installation options, ensure
  136.           that the 'right stuff' is done before the "END".
  137.  
  138.           There is no "IF ALL" to install everything.  If the option to
  139.           install everything is chosen, any "IF BASIC" or "IF ADD-IN"
  140.           instruction sets are ignored.
  141.  
  142.           INSTALL DIRECTORY \HANDS_ON\ # to specify the \HANDS_ON\
  143.           directory.
  144.  
  145.           INSTALL HEADER - This allows you to provide an alternate
  146.           header to replace the default message at the upper part of the
  147.           screen.  You may use up to 3 message or header lines.
  148.  
  149.           INSTALL README some_file to allow you to use any file name
  150.           instead of the default README.DOC name.  README.DOC is used in
  151.           place of README.1ST to make it easier to look up a group of
  152.           manuals, ending in ".DOC", with various browsers.
  153.  
  154.           INSTALL ADD-IN or BASIC - to specify that the distribution is
  155.           only a partial distribution.  The installer defaults to asking
  156.           if you want 1) A FULL distribution or 2) Only the REMOTE or
  157.           the HOST (BASIC) or 3) As an ADD-IN to another product like
  158.           bitcom.  Use one of these command options to bypass the
  159.           prompting.
  160.  
  161.           QUIT - to instruct INSTALL to quit to DOS.
  162.  
  163.           QUIT_TO to quit and run another program.  This version of
  164.           Install does NOT use keyboard stuffing to run the next
  165.           program, unlike previous releases.  When you use "QUIT_TO
  166.           some_prog" the program swaps all but 2k of itself to disk and
  167.           runs the "some_prog".  It then swaps itself back in after
  168.           running and immediately quits.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                The Quick & Easy Install manual                 Page 4
  175.  
  176.  
  177.           LASTFILE to specify the last file in a disk set.  This allows
  178.           the installer to look for the last file and automatically
  179.           decide that the installation is a 'one disk' set.  This allows
  180.           you to use the same installation instruction script for 360K
  181.           diskettes, 1.44M diskettes, and BBS type installation.  It
  182.           causes CHANGEDISK type instructions to be ignored.  eg.:
  183.           "LASTFILE lastdisk.zip".  The Sept/94 update adds a logical
  184.           switch DIRECT_INSTALL that becomes True if the LASTFILE is
  185.           present when the installer reads in the install script in
  186.           install.dbf.  You can use it with IF ... ENDIF as shown above,
  187.           most likely for installations from files downloaded from a
  188.           BBS.  If you are installing an update and the lastfile already
  189.           exists in the target directory, the installer will assume a
  190.           BBS type of installation and bypass most of the update.  So
  191.           erase the lastfile before doing the update.
  192.  
  193.           # if the 'lastfile' has been found this IF will be entered
  194.           IF direct_install
  195.             some stuff
  196.             ...
  197.             quit
  198.           ENDIF
  199.  
  200.           Please note that a side effect of the LASTFILE command is that
  201.           the installer logical rule base goes bonkers if you use
  202.           LASTFILE and install a second time over the first set of
  203.           files, from 5 1/4" diskettes.  It then decides that you are
  204.           actually installing from a 3 1/2" diskette, and mistakenly
  205.           avoids asking you to change disks.
  206.  
  207.           RUN - to tell INSTALL to run the program on the same line.
  208.           For both RUN and SWAP, install looks for the file to be run in
  209.           both the source and the destination directories, and runs it
  210.           where it was found with the current directory being the
  211.           destination directory.  This means that it works with self-
  212.           extracting archive files and software that has been
  213.           installed.  Use the COMMAND command to simply run programs and
  214.           to pass commands to command.com.  If you are running a batch
  215.           file, ending in .BAT, use "COMMAND /C that.BAT".  Use swap if
  216.           you need all but 2K of memory.  The parser ignores ".COM"
  217.           files, so add the .com if you want to RUN or SWAP .com files.
  218.  
  219.           SWAP - to tell INSTALL to SWAP all but 2k of itself to disk
  220.           before running the program given on the same line.
  221.  
  222.           Examples:
  223.           CLEAR
  224.           RUN  some
  225.           SWAP  bigthing # swap all but 2k of the program to disk
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                The Quick & Easy Install manual                 Page 5
  232.  
  233.  
  234.           WAIT to wait for the user to press a key to continue.  The
  235.           wait is actually a long delay.
  236.  
  237.           The best way to learn how to use INSTALL is to study an
  238.           existing script in the INSTALL.DBF/DBT file. Run 'INSTALL
  239.           EDIT', and compare its actions to the command script. Practise
  240.           with small scripts and work up.  Test your setups.
  241.  
  242.           If you use the install program very much to install other
  243.           software, you will notice that the size of the install.dbt
  244.           file builds up.  Use the ITUNE.EXE program to retune the
  245.           size.  It will automatically reclaim wasted space.
  246.  
  247.  
  248.  
  249.           ASP Introduction:
  250.  
  251.           Please also carefully read the accompanying SHARE.ASP or
  252.           SHR_WARE.DOC document.
  253.  
  254.           "This program is produced by a member of the Association of
  255.           Shareware Professionals (ASP). ASP wants to make sure that the
  256.           shareware principle works for you. If you are unable to
  257.           resolve a shareware-related problem with an ASP member by
  258.           contacting the member directly, ASP may be able to help. The
  259.           ASP Ombudsman can help you resolve a dispute or problem with
  260.           an ASP member, but does not provide technical support for
  261.           members' products. Please write to the ASP Ombudsman at 545
  262.           Grover Road, Muskegon, MI 49442 or send a CompuServe message
  263.           via CompuServe Mail to ASP Ombudsman 70007,3536."
  264.  
  265.  
  266.           DISTRIBUTION:  This product is the property of P. C Softsmith
  267.           (c) 1991-5.  It may be distributed freely, but it is
  268.           shareware.  If you use it to produce setup/installs for
  269.           yourself or others, please send a letter with comments and
  270.           suggestions to P. C. Softsmith.  You do not have to register
  271.           TeleShare or Hands On to include it with your product.
  272.           However, you must include this documentation with any and all
  273.           distributions of INSTALL, and you may not charge more than an
  274.           'industry standard' distribution fee for shareware
  275.           distributors.  See the "History" section below for more
  276.           distribution information.
  277.  
  278.           Support:
  279.  
  280.           Please contact us for TeleShare/Hands ON support and sales at
  281.           P. C.  Softsmith by telephone (604) 433 - 5189 or at Suite 606
  282.           - 6455 Willingdon Avenue, Burnaby, British Columbia, Canada,
  283.  
  284.  
  285.  
  286.  
  287.  
  288.                The Quick & Easy Install manual                 Page 6
  289.  
  290.  
  291.           V5H 4E4.  Both registered and soon to be registered users
  292.           currently get the same support without any arbitrary time
  293.           limit.
  294.  
  295.           Internet and Compuserve users can also direct email to:
  296.  
  297.           COMPUSERVE: 75020 2664
  298.           INTERNET: vic_williams@mindlink.bc.ca
  299.  
  300.  
  301.           Your comments on the product will be appreciated.  Naturally
  302.           we all might expect ongoing changes in the product.
  303.  
  304.  
  305.           History:
  306.  
  307.           February 16, 1995 v2.62 - various minor changes.  It appears
  308.           that the installer may 'argue' with CDROM driver software at
  309.           times, and this may well be related to the DIET compressor
  310.           used on the .EXE.  The BBS logic has been cleaned up a bit.
  311.  
  312.           October 17, 1994 v 2.61 - the logic for the BBS version of the
  313.           package allowed one to choose another drive and directory, but
  314.           did not copy the package to that directory.  Disabled such
  315.           capability with the idea that its a good idea to avoid
  316.           duplicating the files on your system, and most people will
  317.           actually be happy with the files where they unzipped them.  At
  318.           least for test driving purposes..
  319.  
  320.           September, 1994 v 2.6 - still resolving problems with LASTFILE
  321.           and the 3 1/2" and 5 1/4" disk installations.  Removed some of
  322.           the residual Teleshare setup options.
  323.  
  324.           June, 1994 Version 2.5 -- added the LASTFILE command.
  325.  
  326.  
  327.           This install is a version of the installation program used to
  328.           install the FORCE Xbase compiler (the ONLY native code
  329.           producing Xbase compiler), with portions Copyright (C) 1989
  330.           Sophco Inc.  The terms of the distribution agreement are such
  331.           that this install program may only be distributed with P. C.
  332.           Softsmith products.  If you want to distribute it solely with
  333.           your product, please contact us and we will direct you to the
  334.           appropriate contact people.
  335.  
  336.           In mid July 1993, the script language was added to the install
  337.           program and the version was upgraded from 1 to 2.
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.                The Quick & Easy Install manual                 Page 7
  346.  
  347.  
  348.           DISCLAIMER - AGREEMENT
  349.  
  350.           The documentation and associated software are distributed and
  351.           sold with no warranties, either express or implied, regarding
  352.           its merchantability or fitness for any particular purpose.  To
  353.           repeat, the author disclaims all warranties, expressed or
  354.           implied, including, without limitation, the warranties of
  355.           merchantability and of fitness for any purpose.  The author
  356.           assumes no liability for damages, direct or conse- quential,
  357.           which may result from the use of the product with or without
  358.           registration.
  359.  
  360.           The information in this documentation is subject to change
  361.           without notice and does not represent a committment on the
  362.           part of the vendor.
  363.  
  364.  
  365.           THE DOCUMENTATION AND ASSOCIATED SOFTWARE ARE DISTRIBUTED AND
  366.           SOLD WITH NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING
  367.           ITS MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE.
  368.           THE INFORMATION IN THIS DOCUMENTATION IS SUBJECT TO CHANGE
  369.           WITHOUT NOTICE AND DOES NOT REPRESENT A COMMITTMENT ON THE
  370.           PART OF THE VENDOR.
  371.  
  372.           OTHER PRODUCT AND BRAND NAMES MENTIONED ARE TRADEMARKS OR
  373.           REGISTERED TRADEMARKS OF THEIR RESPECTIVE HOLDERS.
  374.           SPECIFICALLY XBASE IS THE GENERIC DATABASE INDUSTRY
  375.           REPLACEMENT FOR THE REGISTERED TERM 'DBASE' OWNED BY BORLAND
  376.           INTERNATIONAL.
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.